Tengo un problema extraño con algunos informes de ESLint en un archivo JavaScript. Agregué algunas definiciones de JSDoc como las siguientes:

 /** * @typedef {Object} CustomRefA * @property {string} attr1 * @property {string} attr2 * @property {Boolean} attr3 * @property {number} attr4 */ /** * @typedef {Object} CustomRefB * @property {string} attr5 * @property {string} attr6 * @property {Boolean} attr7 * @property {CustomRefA} attr8 */

Estas definiciones también se usan para declarar valores de retorno de funciones como esta:

 /** * * @param {Object} params * @param {string} params.attrA * @param {string} params.attrB * @returns {CustomRefA} */ function doesSomeActionA(options) { return { }; } /** * * @param {Object} params * @param {string} params.attrA * @param {CustomRefA} params.attrB * @returns {Object} */ function doesSomeActionB(params) { return { }; }

Sin embargo, lo que no puedo entender es por qué cuando se hace referencia a CustomRefA , ESLint informa con:

Variable no resuelta o tipo 'CustomRefA'

Esto también está provocando que las referencias a los atributos de cualquier objeto asignado con los tipos personalizados también se notifiquen como no resueltos. Esto no parece suceder todo el tiempo, y no he podido encontrar ninguna información que indique diferencias entre proyectos que puedan explicar el problema.

Como referencia, esto está en WebStorm 2021.2, con lo que parece ser ESLint versión 7.32.0 (según Node/NPM). Y he investigado bastante sobre esto, pero no he podido encontrar muchos resultados que se apliquen lo suficiente a la situación.